Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Getting and Playing Movies / Controlling Movie Playback

StartMovie

The StartMovie function starts the movie playing from the current movie time, which is where the movie last stopped playing. Before playing the movie, the Movie Toolbox makes the movie active, prerolls the movie, and sets the movie to its preferred playback rate. You can use the SetMoviePreferredRate function (described on page 2-116) to change this setting.

pascal void StartMovie (Movie theMovie);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

DESCRIPTION

Note that a movie's current time is saved when a movie is stored in a movie file. Therefore, your application should appropriately position a movie before playing the movie--use the GoToBeginningOfMovie function (described on page 2-99) to set a movie to play from its start.

You are not required to call StartMovie to start a movie. This function is included merely for convenience.

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid

Memory Manager errors

SEE ALSO

You can also start a movie playing by calling the SetMovieRate function (described on page 2-172) and setting the movie's rate to a nonzero value.